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CHAPTER 1 
LOGITECH MOUSE DRIVER FUNCTIONS 



This manual describes the functions of the standard mouse driver, provides descriptions of the 
graphics and text cursors, and gives examples of how to use each of the functions from 8086 
assembler and high-level languages. 

The software protocols used by the LOGITECH MOUSE driver are compatible with the standard 
driver protocols of Microsoft Corp. as documented in the installation and operation manual 
published by Microsoft Corp. entitled Microsoft (R) Mouse User's Guide for IBM Personal 
Computers. 

This reference section applies to the LOGITECH Mouse Driver (M0USE.COM and MOUSE.SYS) 
Release 3.00 and above. 

Interface modules are available for a variety of languages. The source code of the interfaces is 
included in the diskette accompanying this manual. 

The floppy diskette that comes with the LOGITECH MOUSE PROGRAMMERS Toolkit contains 
subdirectories (MOD, C, TURBO, MSP) which contain the source code of programs to interface 
the Mouse Driver with a Modula-2, C, Turbo Pascal, Microsoft Pascal program respectively. 

The examples have been written using the Microsoft 8086 Assembler, the LOGITECH MODULA- 
2 compiler, the Microsoft C compiler, the Borland Turbo Pascal compiler, the Microsoft Pascal 
compiler the GWBASIC system and the IBM BASICA system. The interfaces may require some 
adaptations for other compilers, memory models of the 8086, or envirormients. 
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1.1 PROGRAM INTERFACE 



1.1.1 Programming Interface for Assembler 



The mouse driver functions are called through a software interrupt, number 51 (33H). The 
parameters and returned values are passed in the registers. Register AX is always used for the 
function number. 



1.1.2 Programming Interface for Modula-2 

The module MOUSE provides the interface to the mouse driver for a Modula-2 program compiled 
with the LXDGITECH MODULA-2 system. Compile MOUSE.DEF and MOUSE.MOD, and 
include the necessary IMPORT list. 



1.13 Programming Interface for C 

The C interface is written in Microsoft Assembler for the Microsoft C compiler using the large 
model of the 8086. The interface is contained in the file MIFASM. It needs to be assembled and 
the resulting .OBJ object file linked to the application. The interface for other compilers will not 
differ significantly, but it is advisable to look carefully at the source given in MIFASM. 



1.1.4 Programming Interface for Microsoft Pascal 

The Microsoft Pascal interface is written in Assembler for the Microsoft Pascal compiler using the 
large memory model of the 8086. The interface is contained in the file PASMIFASM. It needs to 
be assembled and the resulting .OBJ object file linked to the application. 



1.1.5 Programming Interface for Turbo Pascal 

MOUSEPAS contains the types, constants, variables, procedures needed to interface the mouse 
driver from a Turbo Pascal Program. The Pascal code should be included at the start of the Turbo 
Pascal application program. 
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1.1.6 Programming Interface From the BASIC Interpreter 

It is possible to make a mouse driver function call from a BASIC program running under the IBM 
BASICA system or the GWBASIC interpreter. The following shows how to make these calls. 

Insert an initialization sequence as follows: 

10 DEF SE6=0 

20 MSEG=256*PEEK(51*4+3)+PEEK(51*4+2) 

30 M0USE=256*PEEK(51*4+1 )+PEEK(51*4)+2 

40 DEF SEG=MSEG 



Be sure that the statements appear at the beginning of the program before the first call to a mouse 
function. Then use the CALL statement to make the call. 

CALL H0USE(M1X,H2X,M3%,H4%) 



Where MOUSE is the variable containing the BASIC entry offset of the mouse software, and 
Ml%, M2%, M3%, and M4% are the names of the integer variables you have chosen for 
parameters in this call. They correspond to the values for AX, BX, CX, and DX which are 
described in this document. As an example: 

100 'Set minimum and maximum horizontal position to 

•(320,100) 
200 M1%=7 'function number is 7 

300 M3%=0 'minimum coordinate 

400 M4%=639 'maximum coordinate 

500 CALL M0USE(M1%,M2%,M3%,M4%) 



Note : There are two entry points in the driver, the first is the interrupt entry point (which is the 
address found in the interrupt vector table entry for interrupt 51 ) and the second is the BASIC (or 
FAR CALL) entry point, which is 2 bytes after the interrupt entry point. The second entry point is 
necessary so that the mouse driver functions can be called as BASIC subroutines using the CALL 
statement or using a far call from another language. 
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1.1.7 Notes 

Programs which intercept the video i/o software interrupt (int lOh) should exercise utmost care, 
and the following guidelines should be observed: 

■ The program should guarantee that video mode changes (function 0) are intercepted by 
the mouse driver so that the driver can display the correct type of cursor (text or graphics). 
The mouse driver guarantees consistency of the screen contents to programs that write on 
the screen via int lOh (or via DOS). 

■ Some programs write directly into the video memory. If this is the case the program 
should use function 2 (hide cursor) or 16 (conditional hide cursor) to turn off the cursor 
before writing to the screen. When finished writing, function 1 (show cursor) should be 
called to redisplay the cursor. 

■ To check for the presence in memory of the LOGITECH mouse driver one should check 
for a "signature" at offset 16 (lOH) from the entry point of software interrupt 51 (33H). 
The signature is the string 

"LOOrHECH MOUSE DRIVER", 

■ The presence of the mouse driver must be checked for by examining the interrupt vector 
entry for interrupt 51 (33H). Use DOS function 35H (Get Vector) or check directly the 
offset and segment value at address 0000:OOCCH. The vector may be uninitialized (value is 
zero), in which case the mouse driver has not been loaded and must not be called. If 
initialized, function of the driver will return a flag if the mouse (or driver) is present. 
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1.2 THE STANDARD MOUSE DRIVER FUNCTIONS 



The following is a list of the mouse driver functions and their assigned number. The number is to 
be passed in register AX when calling interrupt 51 (33H). Each is described in its own section 
further in this chapter. 



Function Name 


Number 


Flag Reset (Mouse Initialization) 





(OOH) 


Show Cursor 


1 


(OIH) 


Hide Cursor 


2 


(02H) 


Get Mouse Position & Button Status 


3 


(03H) 


Set Mouse Cursor Position 


4 


(04H) 


Get Button Press Information 


5 


(05H) 


Get Button Release Information 


6 


(06H) 


Set Minimum & Maximum X Position 


7 


(07H) 


Set Minimum & Maximum Y Position 


8 


(08H) 


Define Graphic Cursor 


9 


(09H) 


Define Text Cursor 


10 


(OAH) 


Read Mouse Motion Counters 


11 


(OBH) 


Define Event Handler 


12 


(OCH) 


Light Pen Emulation Mode On 


13 


(ODH) 


Light Pen Emulation Mode Off 


14 


(OEH) 


Set Mouse Motion/Pixel Ratio 


15 


(OFH) 


Conditional Hide Cursor 


16 


(lOH) 


Set Speed Threshold 


19 


(13H) 
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1.2.0 FUNCTION - RESET 

This function checks the presence of the mouse, resets it, and initializes the driver. All current 
features are reset to their initial values. Return parameters are mouse status (0 if the mouse is not 
connected, -1 if connected) and the number of buttons on the mouse. 



Input 



AX = 



Output 



The initial values are: 



Cursor: 



AX = mouse status 
BX = number of buttons 



invisible 

arrow in graphics mode 

software cursor in text mode 



Event Handler: NIL 

Minimum X Position: 

Maximum X Position: 639 

Minimum Y Position: 

Maximum Y Position: 199 



Function - Reset 



1.2.0.1 Calling Reset (0) from Assembly Language 

After checking that the mouse driver is loaded (interrupt vector not zero), call function and 
check for the returned value. It is recommended to check for the returned value zero, which 
indicates that no mouse or driver is present (AX remains zero). 



; Check if the 


interrupt 


vector is 


set 


correctly 


NOV 




AL, 33H 






MOV 




AH, 35H 




; Get Vector 


INT 




21H 




; From DOS 


CMP 




BX, 




; Is offset in BX zero? 


JNZ 




M0USE_OtC 






MOV 




AX, ES 






CMP 




AX, 




; Is segment in ES zero 


JNZ 




MOUSE OK 







You get here if the mouse interrupt is not initialized 

JMP NO_MOUSE 

Now check for the presence of the mouse (and driver), and reset 
the driver and the mouse 



M0USE_0K: 




MOV 


AX, 


INT 


33H 


TEST 


AX, AX 


JNZ 


MOUSE_READY 


JMP 


NO HOUSE 



; Zero in AX means no mouse 



U.0.2 Calling Reset (0) from Modula-2 

Mouse.DriverInstalIed already indicates whether the interrupt vector has been initialized. 

MODULE test; 
IMPORT Mouse; 
VAR 

mouseStatus : INTEGER; 

noButtons : CARDINAL; 

BEGIN 

mouseStatus := 0; 

IF Mouse.DriverInstalIed THEN 

Mouse.FlagReset ( mouseStatus, noButtons >; 
IF mouseStatus = THEN 

(* Mouse not available *) 
END 
END 
END test. 
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1.2.0 J Calling Reset (0) from C 

teste ) 

<: 

int mouseStatus > 0; 
unsigned noButtons; 

if DriverlnstalledO 

FlagReset ( SinouseStatus, &noButtons ); 
if ( mouseStatus «> ) 

i I* mouse not available */ > 
> 



1.2.0.4 Calling Reset (0) from Microsoft Pascal 

program test; 

function Driverlnstalled: boolean; EXTERN; 
procedure FlagReset( VARS mouseStatus, 

numberOf Buttons: Integer); EXTERN; 

var 

mouseStatus, noButtons : Integer; 
begin 

if Driverlnstalled () then 
begin 

FlagReset ( mouseStatus, noButtons ); 
if mouseStatus « then 
(* mouse not avai lable *) 
end 
end. 



1.2.0.5 Calling Reset (0) from Turbo Pascal 

program test; 
<$i mouse. pas> 
var 

mouseStatus, noButtons : Integer; 



begin 

if DriverlnstalledO then 
begin 

FlagReset ( mouseStatus, noButtons >; 
if mouseStatus s o then 
(* mouse not available *) 
end 
end. 
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1.2.0.6 Calling Reset (0) from Basic 

10 DEF SEG « 

20 MSEC e 256*PEEK<51*4+3)+PEEK<51*4+2) 

30 IF MSEC = THEN 90 

40 ENTRY » 256*PEEK(51*4+1)+PEEK<51*4) 

50 DEF SEG > MSEG 

60 IF PEEIC(ENTRY) = 207 THEN 90 

70 GOTO 100 

90 PRINT "Mouse Driver Not Loaded" : END 

100 PRINT "Mouse Driver Loaded OK" 

200 MOUSE « ENTRY-«-2 • basic entry point 

210 M1% >: 

220 CALL MOUSE (M1%,M2X,M3%,M4%) 

230 IF M1% = -1 THEN 290 

240 PRINT "Mouse not responding" : END 

290 ' Mouse is connected and responding - continue 

500 ' the rest of your program 
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1.2.1 FUNCTION 1 ■ SHOW CURSOR 

Show Cursor makes the mouse driver cursor visible. The cursor shape is as defined by function 9 
(Define Graphics Cursor) or 10 (Define Text Cursor) according to the current video mode. 

Refer to function 2 (Hide Cursor) for information on how many calls to Show Cursor are needed 
to make the cursor visible after calling Hide Cursor. 

Input 

AX=1 

Output 

none 



1.2.1.1 Calling Show Cursor (1) from Assembler 

SHOU_CURSOR: 

MOV AX, 1 

INT 33H 



1.2.1.2 Calling Show Cursor (1) from Modula-2 

MODULE test; 
IMPORT Mouse; 
BEGIN 

Mouse . ShowCursor; 
END test. 



1.2.1 J Calling Show Cursor (1) from C 

test () 
i 

ShowCursor (); 
> 



1.2.1.4 Calling Show Cursor (1) from Microsoft Pascal 

program test; 

procedure ShowCursor; EXTERN; 

begin 

ShowCursor; 
end. 
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1.2.13 Calling Show Cursor (1) from Turbo Pascal 

program test; 
<;$! mouse. pas> 



begin 

ShowCursor; 
end. 



1.2.1.6 Calling Show Cursor (1) from Basic 

200 ' assuming set up as in A. 2.1 

210 MIX » 1 

220 CALL MOUSE (M1%, M2%, M3%, M4%) 



12 LOGriECH MOUSE Driver Functions 



1.2.2 FUNCTION 2 -HIDE CURSOR 

This function makes the cursor invisible. Although the cursor is hidden it still tracks the motion of 
the mouse, changing position as the mouse changes position. 

The Hide Cursor function is cumulative. The cursor visibility status can be seen as a counter which 
is 1 when the cursor is visible, and or negative when the cursor is invisible. Hide Cursor 
decrements the status, making the cursor invisible when going from 1 to 0. Show Cursor 
increments the status, with a maximum value of 1. When the status reaches 1, the cursor is made 
visible. This means that two calls to Hide Cursor will be canceled by two calls to Show Cursor. 

Input 

AX = 2 

Output 

none 



1.2.2.1 Calling Function 2 from Assembler 

HIDE_CURSOR: 

MOV AX, 2 

INT 33H 



1.2.2.2 Calling Function 2 from Modula-2 

MODULE test; 
IMPORT Mouse; 
BEGIN 

Mouse. HideCursor; 
END test. 



1.2.23 Calling Function 2 from C 
testO 

HideCursorO; 
> 



1.2.2.4 Calling Function 2 from Microsoft Pascal 

program test; 

procedure HideCursor; EXTERN; 

begin 

HideCursor; 
end. 
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1.2.2.5 Calling Function 2 from Turbo Pascal 

program test; 
{${ mouse. pas> 



begin 

HideCursor; 
end. 



1.2.2.6 Calling Function 2 from Basic 

200 ' assuming set up as in A. 2.1 

210 M1% = 2 

220 CALL MOUSE (Ml%, M2%, M3%, M4%) 
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1.23 FUNCTION 3 - GET MOUSE POSITION & BUTTON STATUS 

This function reports the status of the buttons and the position of the cursor horizontally and 
vertically. The button status is a single integer value with bit representing the left button, bit 1 
the right and bit 2 the middle. "When a button is down the corresponding bit is 1 and when a 
button is up the bit is 0. 

Input 

AX = 3 

Output 

BX = button status 

CX = horizontal cursor position 

DX = vertical cursor position 



1.23.1 Calling Function 3 from Assembler 

GET_POS_BUT: 

HOV AX, 3 

INT 33H 



1.23.2 Calling Function 3 from Modula-2 

MODULE test; 
IMPORT Mouse; 
VAR 

buttonSet : Mouse. But tonSet; 

horizontal, vertical : INTEGER; 

BEGIN 

Mouse. GetPosBut (buttonSet, horizontal, vertical); 
END test. 



1.233 Calling Function 3 from C 

testo 
i 

struct < 

unsigned leftButton : 1 

unsigned rightButton : 1 

unsigned middleButton : 1 

> *buttonStatus; 

int *horizontal, *vertical; 

GetPosBut (buttonStatus, horizontal, vertical); 
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1.23.4 Calling Function 3 from Microsoft Pascal 

program test; 

procedure GetPosBut ( VARS buttonStatus, horizontal, vertical : 

Integer ); EXTERN; 
var 

buttonStatus, horizontal, vertical : Integer; 

begin 

GetPosBut (buttonStatus, horizontal, vertical); 
end. 



1.23.5 Calling Function 3 from Turbo Pascal 

program test; 
<I$i mouse. pas> 
var 

buttonStatus, horizontal, vertical : Integer; 
begin 

GetPosBut (buttonStatus, horizontal, vertical); 
end. 



1.23.6 Calling Function 3 from Basic 

200 ' assuming set up as in A. 2.1 

210 MIX s 3 

220 CALL MOUSE (M1%, M2X, M3X, M4X) 

230 IF M2% AND 1 THEN PRINT "Left Button Pressed" 

240 IF M2% AND 2 THEN PRINT "Right Button Pressed" 

250 IF M2% AND 4 THEN PRINT "Middle Button Pressed" 
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1.2.4 FUNCTION 4 - SET MOUSE CURSOR POSITION 

This function sets the cursor position to the specified horizontal and vertical location on the 
screen. The new values must be within the specified ranges for the mode of the screen (see Chapter 
3, section 5 for table of coordinates). If you are using a text screen mode, the values are rounded to 
the nearest values permitted by the screen for horizontal and vertical positions (ie to character 
boundaries). 

Input 

AX = 4 

CX = new horizontal cursor position 

DX = new vertical cursor position 

Output 

none 



1.2.4.1 Calling Function 4 from Assembler 

SET CURSOR PCS: 



MOV 


AX, A 


MOV 


CX, HORIZ 


MOV 


DX, VERT 


INT 


33H 



1.2.4.2 Calling Function 4 from Modula-2 

MODULE test; 
IMPORT Mouse; 
VAR 

horizontal, vertical : INTEGER; 

BEGIN 

Mouse. SetCursorPos (horizontal, vertical); 
END test. 



12A3 Calling Function 4 from C 

testO 
C 

int horizontal, vertical; 

SetCursorPos (horizontal, vertical); 
> 
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1.2.4.4 Calling Function 4 from Microsoft Pascal 
program test; 

procedure SetCursorPos (horizontal, vertical : Integer);EXTERN; 

var 

horizontal, vertical : Integer; 

begin 

SetCursorPos (horizontal, vertical); 
end. 



1.2.4.5 Calling Function 4 from Turbo Pascal 

program test; 
{$i mouse. pas> 



var 

horizontal, vertical : Integer; 

begin 

SetCursorPos (horizontal, vertical); 
end. 



1.2.4.6 Calling Function 4 from Basic 

200 ' assuming set up as in A. 2.1 

210 M1% = 4 

220 M3% = • horizontal 

230 M4% = • vertical 

240 CALL MOUSE (Ml%, M2%, M3%, H4%) 
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12.5 FUNCTION 5 - GET BUTTON PRESS INFORMATION 

This function returns a count of button presses since the last call to this function. It also returns 
the horizontal and vertical position of the cursor at the time of the last press of the specified button 
and the status of the other buttons at that moment. 

Input 

AX = 5 

BX = button of interest (0: Left, 1: Right, 2: Middle) 

Output 

AX = button status 

BX = number of button presses on specified button 
CX = horizontal cursor position at last press 
DX = vertical cursor position at last press 

Notes : The BX register input parameter indicates which button the report is to be made 

on. 

The AX register, on return from the function, contains the current status of all the mouse 

buttons. Each button is represented by a single bit, 1 => button pressed. 

AX : Bit = Left Button 
Bit 1 = Right Button 
Bit 2 = Middle Button 



1.2.5.1 Calling Function 5 from Assembler 

GET_BUTTON_PRESS: 

NOV AX, 5 

MOV BX, BUTTON 

INT 33H 



1.2.5.2 Calling Function 5 from Modula-2 

MODULE test; 
IMPORT Mouse; 
VAR 

button : Mouse. Button; 

buttonStatus : Mouse. ButtonSet; 

buttonPressCount : CARDINAL; 

horizontal, vertical : INTEGER; 

BEGIN 

Mouse. GetButPres (button, buttonStatus, buttonPressCount, horizontal, vertical); 
END test. 
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1.2.53 Calling Function 5 from C 
testo 

int button, buttonStatus, buttonPressCount, horizontal, vertical; 

GetButPres (button, &buttonStatus, &buttonPressCount, &horizontal, &vertical); 
> 



1.2.5.4 Calling Function 5 from Microsoft Pascal 

program test; 

procedure GetButPres (button : Integer;VARS buttonStatus, buttonPressCount, horizontal, vertical 

Integer); EXTERN; 

var 

button, buttonStatus, buttonPressCount, horizontal, vertical : Integer; 
begin 

GetButPres (button, buttonStatus, buttonPressCount, horizontal, vertical); 
end. 



1.2.5.5 Calling Function 5 from Turbo Pascal 

program test; 
C$i mouse. pas> 

var 

button, buttonStatus, buttonPressCount, horizontal, vertical : Integer; 
begin 

GetButPres (button, buttonStatus, buttonPressCount, horizontal, vertical); 
end. 



1.2.5.6 Calling Function 5 from Basic 

200 ' assuming set up as in A. 2.1 

210 M1% = 5 

220 M2% s 1 • Right Button 

230 CALL MOUSE (M1%, M2%, M3%, M4%) 

240 IF (M1% AND 2) THEN PRINT "Right button pressed" 
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1.2.6 FUNCTION 6 - GET BUTTON RELEASE INFORMATION 

This function returns a count of button releases since the last call to this function. It also returns 
the horizontal and vertical position of the cursor at the time of the last release of the specified 
button and the status of the other buttons at that moment. 

Input 

AX = 6 

BX = button of interest (0 :Left, 1 :Right, 2 iMiddle) 

Output 

AX = button status 

BX = number of button releases on specified button 
CX = horizontal cursor position at last release 
DX = vertical cursor position at last press 



Input : The BX register input parameter indicates which button the report is to be made on. 

Output : The AX register, on return firom the function, contains the current status of all the mouse 
buttons. Each button is represented by a single bit, 1 => button pressed. 

AX : Bit = Left Button 

Bit 1 = Right Button 
Bit 2 = Middle Button 



1.2.6.1 Calling Function 6 from Assembler 



GET_BUT_REL: 




MOV 


AX. 6 


MOV 


BX, BUTTON 


IMT 


33H 


MOV 


BUTTON_STATUS, AX 


MOV 


BUTTON_REL_COUNT, BX 


MOV 


HORIZ, CX 


MOV 


VERT, DX 



1.2.6.2 Calling Function 6 from Modula-2 

MODULE test; 
IMPORT Mouse; 
VAR 

button : Mouse. But ton; 

buttonStatus : Mouse. ButtonSet; 

buttoN^eleaseCount : CARDINAL; 

horizontal, vertical : INTEGER; 

BEGIN 

Mouse.GetButRel (button, buttonStatus, buttor«eleaseCount, horizontal, vertical); 
END test. 



Function 6 - Get Button Release Info 21 



1.2.6 J Calling Function 6 from C 
testO 

Int button, iauttonStatus, buttonReleaseCount, horizontal, vertical; 

GetButRel (button, &buttonStatus, &buttonReleaseCount, &horizontal, &vertical); 
> 



1.2.6.4 Calling Function 6 from Microsoft Pascal 

program test; 

procedure GetButRel (button : Integer;VARS buttonStatus, buttonReleaseCount, 

horizontal, vertical : Integer);EXTERN; 

var 

button, buttonStatus, buttonReleaseCount, horizontal, vertical : Integer; 
begin 

GetButRel (button, buttonStatus, buttonreleasecount, horizontal, vertical); 
end. 



1.2.6.5 Calling Function 6 from Turbo Pascal 

program test; 
<$i mouse. pas> 

var 

button, buttonStatus, buttonReleaseCount, horizontal, vertical : Integer; 
begin 

GetButRel (button, buttonStatus, buttonreleasecount, horizontal, vertical); 
end. 



1.2.6.6 Calling Function 6 from Basic 

200 ' assuming set up as in A. 2.1 

210 MIX = 6 

220 M2% s 2 • Middle Button 

230 CALL MOUSE (MIX, M2X, M3X, MAX) 

240 IF (MIX AND 4) THEN PRINT "Middle button released" 
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1.2.7 FUNCTION 7 - SET MINIMUM & MAXIMUM X POSITION 

This function sets the minimum and maximum horizontal cursor positions on the screen. All 
cursor movement is restricted to this area once the area is set. 

If the cursor is outside the defined area when the call is made, it moves to just inside the area. If 
the minimum value is greater than the maximum, the two values are exchanged. 

Input 

AX = 7 

CX = new minimum horizontal cursor position 

DX = new maximum horizontal cursor position 

Output 

none 



1.2.7.1 Calling Function 7 &x)m Assembler 

SET_H0RI2ONTAL_LIMITS: 
MOV AX, 7 
MOV CX, MIN_POS 
MOV DX, MAX_P0S 
INT 33H 



12.7.2 Calling Function 7 from Modula-2 

MODULE test; 
IMPORT Mouse; 
VAR 

minPos, maxPos : INTEGER; 

BEGIN 

Mouse. SetHorizonta I Limits (minPos, maxPos); 
END test. 



1.2.73 Calling Function 7 from C 

testO 

int minPos, maxPos; 

i 

SetHorizontalLimits (minPos, maxPos); 
> 



1.2.7.4 Calling Function 7 from Microsoft Pascal 

program test; 

procedure SetHorizontalLimits (minPos, maxPos : Integer); EXTERN; 

begin 

SetVertica I Limits (minPos, maxPos); 
end. 
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1.2.7.5 Calling Function 7 from Turlw Pascal 

program test; 
{${ mouse. pas> 



var 
minPos, maxPos : Integer; 

begin 

SetHorizontalLimits (minPos, maxPos); 
end. 



12.7 j6 Calling Function 7 from Basic 

200 ■ assuming set up as in A. 2.1 

210 M1% = 7 

220 M3% = 100 • Min X value 100 

230 M4% = 200 • Max X value 200 

240 CALL MOUSE (M1%, M2%, M3%, M4%> 
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1.2.8 FUNCTION 8 - SET MINIMUM & MAXIMUM Y POSITION 

This function sets the minimum and maximum vertical cursor positions on the screen. All cursor 
movement is restricted to this area once the area is set. 

If the cursor is outside the defined area when the call is made, it moves to just inside the area. If 
the minimum value is greater than the maximum, the two values are exchanged. 

Input 

AX = 8 

CX = new minimum vertical cursor position 

DX = new maximum vertical cursor position 

Output 

none 



1.2.8.1 Calling Function 8 from Assembler 

SET_VERTICAL_L1MITS: 

MOV AX, 8 
MOV CX, MIN_P0S 
MOV DX, MAX_P0S 
INT 33H 



1.2.8.2 Calling Function 8 from Modula-2 

MODULE test; 
IMPORT Mouse; 
VAR 

mfnPos, maxPos : INTEGER; 

BEGIN 

Mouse. SetVerticalLimits (minPos, maxPos); 
END test. 



1.2.83 Calling Function 8 from C 

testO 

int minPos, maxPos; 

C 

SetVerticalLimits (minPos, maxPos); 
> 



1.2.8.4 Calling Function 8 from Microsoft Pascal 

program test; 

procedure SetVerticalLimits (minPos, maxPos : Integer);EXTERN; 

begin 

SetVerticalLimits (minPos, maxPos); 
end. 
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1.2.8.5 Calling Function 8 from Turbo Pascal 

program test; 
{$! mouse. pas> 
var 

infnPos, maxPos : Integer; 
begin 

SetVertica I Limits (minPos, maxPos); 
end. 



12.S.6 Calling Function 8 from Basic 

200 ' assuning set up as in A. 2.1 

210 M1% = 8 

220 M3X = 50 ' Min Y value 50 

230 M4X = 150 • Max Y value 150 

240 CALL MOUSE (M1%, M2%, M3%, M4%) 



26 LOGITECH MOUSE Driver Functions 

1.2.9 FUNCTION 9 - DEFINE GRAPHIC CURSOR 

Graphics Cursor 

The graphics cursor as displayed on the screen is an array of pixels (16x16 or 8x8 depending on 
screen mode). It is defined by two 16x16 arrays of bits called the screen mask and the cursor mask. 

The screen mask is ANDed with the screen contents. The cursor mask is then XORed with the 
result. 

The operational behavior of these bit arrays are summarized by the following table: 

screen mask cursor mask resulting screen bit 



1 1 

1 UNCHANGED 
1 1 INVERTED 

Hot Spot : When a mouse function refers to the graphics cursor location it is referring to the point 
on the screen that lies directly under the cursor's target area. The target area is the point in the 
cursor block that the mouse software uses to determine the cursor coordinates. This point is 
generally referred to as the hot spot of the cursor. 

Define Graphic Cursor determines what the shape and color of the cursor will be when it is in 
graphics mode, and it identifies the center of the cursor. The cursor block is a 16 X 16 bit pattern. 
The cursor hot spot values must be within the range of -16 to 16. They define one pixel inside or 
near the cursor block. 

The default graphics cursor (i.e. before function 9 is called) is an arrow, with the hot spot at the 
upper left-hand comer. 



Input 



AX = 9 

BX = horizontal cursor hot spot 

CX = vertical cursor hot spot 

ES:DX = address of screen and cursor mask 



Output 



none 



The screen and cursor mask is made of 32 words (16 bits), the first group of 16 words being the 
screen mask, and the second group the cursor mask. 
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1.2.9.1 Calling Function 9 from Assembler 



SET GRAPHIC CURSOR: 



Cross_CURS0R: 






DU 


-4081, -4081.-4081, 7224, 0, 


DW 


0, 7224, -4081, -4081, -4081, -1 


DU 


-1, 


-1, -1, -1, 0, 2016 


DU 


384. 


384. 16770, 32766, 16770, 384 


DU 


384. 


2016, 0, 0, 0, 


DU 


0, 


HOT_SPOT_X EQU 


7 




HOT_SPOT_Y EQU 


5 




SET_Cross_CURSOR: 




MOV 


AX, 


9 


MOV 


BX, 


HOT_SPOT_X 


MOV 


cx. 


HOT_SPOT_Y 


PUSH 


DS 




POP 


ES 




LEA 


DX, 


Cross_CURS0R 


INT 


33H 





1.2.9.2 Calling Function 9 from Modula-2 

MODULE test; 
IMPORT Mouse; 
VAR 

cursor : Mouse. GraphicCursor; 
BEGIN 

UITH cursor DO 

screenMask [0] := BITSET(2016); screenMask[1] := BITSET(960); 

screenMask [2] := BITSET( -32383); screenMask[3] := BITSET(- 16381); 

screenMask [4] := BITSET(-8185); screenMask [5] := BITSET(-4081); 

screenMask[6] := BITSET(-8185); screenMask [7] := BITSET(- 16381); 

screer#1ask[83 := BITSET( -32383); screenMask [9] := BITSET<960); 

screenMask [10] := BITSET(2016); screerMask[11] := BITSET(-I); 

screenMask t1 21 := BITSET(-I); screer*1askC13j := BITSET<-1); 

screenMask [14] := BITSET(-I); screenMask [15] := BITSET(-I); 

cursorMask[0] := BITSET<0); cursorMask[1] := BITSET(30750); 

cursorMask[2] := BITSET<15420); cursorMask [3] := BITSET<7800); 

cursorMask[4] :» BITSET(4080); cursorMask [5] :« BITSET(2016); 

cursorMask [63 := B1TSET(4080); cursorMask [7] := BITSET(7800); 

cursorMask[8] := BITSET(15420); cursorMask [9] := BITSET<30750); 

cursorMask [10] := BITSET(O); cursorMask [11] := BITSET(O); 

cursorMask [12] := BITSET(O); cursorMask [13] := BITSET(O); 

cursorMask [14] := BITSET(O); cursorMask [15] := BITSET(O); 

hotX := 7; hotY := 5; 
END; 

Mouse. SetGraphfcCursor (cursor); 
END test. 
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1.2.93 Calling Function 9 from C 

mainO 
<. 
graph icCursor_type XCursor >= < 

t4080, 2016, -31807, -15997, -8185, -4081, -2017, -4081, 
-8185, -15997, -31807, 2016, 4080, -1, -1, -1, 
0, 28686, 14364, 7224, 3696, 2016, 960, 2016, 
3696, 7224, 14364, 28686, 0, 0, 0, 0, 
7, 6 

>; 

SetGraphicCursor (ftXCursor); 
> 
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1.2.9.4 Calling Function 9 from Microsoft Pascal 



program test; 






type 






cursortype = 


record 
screenHask, 






cursorMask : 


array [0.. 15] of integer; 




hotX, hotY : 


integer; 




end; 





procedure SetGraphicCursor (VARS cursor : cursortype);EXTERN; 

procedure SetCursorToX; 
VAR 

cursor : cursortype; 
begin 
with cursor do 
begin 
screenMa8k[0] :> 4080; 8creenMask[1] :« 2016; 
screenMask[2] := -31807; screenMask[3] := -15997; 
screenMaskt4] := -8185; screenMask[5] := -4081; 
screenMask[6] :- -2017; screenMa8k[7] :' -4081; 
screenMask 18] := -8185; screenMask t9] := -15997; 
8creenMask[10] := -31807; screenMask [11] :« 2016; 
screenMask [12] := 4080; screenMask [13] := -1; 
screenMask [14] := -1; screenMask [15] := -1; 

cursorMask [0] := 0; cursorMask [1] :- 28686; 
cursorMask [2] :- 14364; cursorMask [3] := 7224; 
cursorMask [4] := 3696; cursorMask [5] :s 2016; 
cursorMask [6] := 960; cursorMask [7] := 2016; 
cursorMask [8] := 3696; cursorMask[9] := 7224; 
cursorMask [10] := 14364; cursorMask [11] :- 28686; 
cursorMask [12] :s 0; cursorMask [13] x- 0; 
cursorMask [14] := 0; cursorMask [15] := 0; 



hotX := 0; 
hotY := 0; 
end; (* with *) 
SetGraphicCursor (cursor); 
end; 
begin 

SetCursorToX; 
end. 
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1.2.9.5 Calling Function 9 from Turbo Pascal 

program test; 

{${ mouse. pas> (* LOGITECH MOUSE Turbo Pascal Interface *) 

procedure SetCursorToCross; 
const 
CrossCursor : Graph icCursor = 

(screer*lask: (-4081, -4081, -4081, 7224, 0, 0, 0, 7224, 

-4081, -4081, -4081, -1, -1, -1, -1, -1); 
cursorMask: (0, 2016, 384, 384, 16770, 32766, 16770, 384, 
384, 2016, 0, 0, 0, 0, 0, 0); 
hotX: 7; 
hotY: 5); 
begin 

SetGraph IcCursor (Crosscursor); 
end; 

begin 

Hi Res; 

ShowCursor; 

SetCursorToCross; 
end. 
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1.2.9.6 Calling Function 9 from Basic 



190 


■ assuming setup as in A. 2.1 


200 


• Set the cursor to Cross 


210 


• (this code generated automatically by 


215 


■ LOGITECH HOUSE Cursor Design program 


220 




230 


CURSOR%(0,0) = -1 


240 


CURSOR%(1,0) = -4081 


250 


CURSOR%(2,0) = -4081 


260 


CURSOR%(3,0) = -4081 


270 


CURSOR%(4,0) = 7224 


280 


CURSOR%(5,0) = 


290 


CURSOR%(6,0) = 


300 


CURSOR%(7,0) = 


310 


CURSOR%(8,0) = 7224 


320 


CURSOR%(9,0) s -4081 


330 


CURSOR%(10,0) = -4081 


340 


CURSOR%(11,0) = -4081 


350 


CURSOR%(12,0) = -1 


360 


CURSOR%(13,0) = -1 


370 


CURSOR%(14,0) = -1 


380 


CURSOR%(15,0) = -1 


390 




400 


CURSOR%(0,1) = 


410 


CURS0R%(1,1) = 


420 


CURS0R%(2,1) = 2016 


430 


CURS0R%(3,1) = 384 


440 


CURS0R%(4,1) = 384 


450 


CURS0R%(5,1) = 16770 


460 


CURS0R%(6,1) « 32766 


470 


CURSOR5i(7,1) = 16770 


480 


CURS0RX(8,1) « 384 


490 


CURS0R%(9,1) « 384 


500 


CURSOR%(10,1) » 2016 


510 


CURS0RX(11,1) = 


520 


CURS0R%<12,1) » 


530 


CURS0R%(13,1) = 


540 


CURS0R%(14,1) s 


550 


CURS0R%(15,1) = 


560 




570 


MIX = 9 


580 


M2X = 7 


590 


M3X = 6 


600 


CALL MOUSE (MIX, M2X, M3X, CURSOR%(0,0» 
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1.2.10 FUNCTION 10 - DEFINE TEXT CURSOR 

The text cursor is a cursor that can be used when the video is in one of the text modes. Two kinds 
of text cursors are supported: a hardware text cursor and a software text cursor (for more detailed 
information on the text cursor see Chapter 3 section 6) 

The hardware text cursor is the cursor actually placed on the screen by the video controller itself. It 
is defined in terms of the scan lines of the character cell numbered from starting from the top 
scan line. The numbers of scan lines on a character cell depends on the actual video controller and 
monitor (see the controller documentation for details). 

The software text cursor is a character or a character attribute that replaces and/or modifies the 
character cell on the screen where it is positioned. 

The behavior of this cursor is defined by two 16-bit values. 

The format of the two values is the following: 

BIT DESCRIPTION 

15 blinking (1) or non blinking (0) character 

14-12 background color 

11 high intensity (1) or medium intensity (0) 

10-8 foreground color 

7-0 character code 

The two values are called the screen mask and the cursor mask. The screen mask is used to 
determine which of the character attributes are preserved (it is ANDed with the screen character 
and attribute). The cursor mask is used to determine which of the characteristics are changed by 
the cursor (it is XORed with the result of the previous operation). 

The BX input register selects whether the software or hardware cursor is used by the mouse driver. 

If the hardware cursor is selected (BX = 1), the CX and DX input registers should contain 
the first and last scan lines of the cursor which will be shown on the screen. The range of 
these scan line values depends on the display adapter of the computer (0..7 for IBM 
monochrome adapter, 0..14 for IBM CGA - see Chapter 3, section 5 for further details). 

If the software text cursor is selected (BX = 0), CX and DX specify the screen and cursor 
masks. 



Input 



AX=10 

BX = select cursor (0 -> software cursor, 1 -> hardware cursor) 

CX = screen mask value/scan line start 

DX = cursor mask value/scan line stop 



Output 



none 
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1^.10.1 Calling Function 10 from Assembler 

SET TEXT CURSOR: 



MOV 


AX, 


10 


MOV 


BX, 





MOV 


CX, 


077FFH 


MOV 


DX. 


07718H 


INT 


33H 





1^.10.2 Calling Function 10 from Modula-2 

PROCEDURE SetTextCursorToArrow; 
CONST 

UPARROW = 018H; 

BLANK s OH; 

SCREENMASKATTR = 077H; 

CURSORMASKATTR ^ 077H; 

SOFTUARECURSOR = OH; 
BEGIN 

Mouse. SetTextCursor (S0FTUARECURS0R,SCREENMASKATTR*256+BLANK, CURSORMASKATTR*256+UPARROW) ; 
END SetTextCursorToArrow; 



1.2.103 Calling Function 10 from C 

testO 
{ 

SetTextCursorToArrow( } 
< 

int UPARROU = 0x018; 

int BLANK = 0x0; 

int SCREENMASKATTR = 0x077; 

int CURSORMASKATTR = 0x077; 

int SOFTUARECURSOR = 0x0; 

SetTextCursor (SOFTUARECURSOR, SCREENMASKATTR*256+BLANK, 

CURS0RHASKATTR*256-»-UPARR0U) ; 
> 
> 
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1.2.10.4 Calling Function 10 from Microsoft Pascal 



program test; 

procedure SetTextCursor (selectedCursor, 

screenMaskORscanStart , 
cursorMaskORscanStop : Integer 
); EXTERN; 

procedure SetTextCursorToArrow; 
const 

UPARROU - 018H; 

BLANK - OH; 

SCREENMASKATTR = 077H; 

CURSORMASKATTR = 077H; 

SOFTUARECURSOR ' OH; 
begin 

SetTextCursor (SOFTWARECURSOR, SCREENHASKATTR*256+BLANK, 
CURSORMASICATTR*256+UPARROU) ; 
end; 

begin 

SetTextCursorToArrow; 
end. 



1.2.10.5 Calling Function 10 from Turbo Pascal 

program test; 

iti inou8e.pas> (* LOGITECH MOUSE Turbo Pascal Interface *) 

procedure SetTextCursorToArrow; 
const 

UPARROU s 018H; 

BLANK = OH; 

SCREENMASKATTR « 077H; 

CURSORMASKATTR = 077H; 

SOFTUARECURSOR = OH; 
begin 

SetTextCursor (SOFTUARECURSOR, SCREENMASKATTR*256+BLANK, 
CURSORMASKATTR*256+UPARROU) ; 
end; 

begin 

SetTextCursorToArrow; 
end. 
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1.2.10.6 Calling Function 10 from Basic 

200 ■ assuming setup as In A. 2.1 

210 MIX = 10 

220 M2X B ■ select software cursor 

230 M3% = &H77FF • screen mask 

240 MAX « &H7718 • cursor mask 

250 CALL M0USE(M1X, M2%, M3X, MAX) 
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1.2.11 FUNCTION 11 - READ MOUSE MOTION COUNTERS 

This function returns the horizontal and vertical step count (the distance the mouse has moved in 
1/200 inch increments) since the last call to this function. The step count is always within the range 
-32768 to 32767. A positive horizontal count specifies a motion from left to right while a positive 
vertical count specifies a motion towards the user (assuming the mouse is in the conventional 
orientation, cable pointing away from user). The step count is reset to after the call is completed. 

Input 

AX=11 

Output 

CX = horizontal count 
DX = vertical count 



Note: In the LOGITECH MOUSE driver there is an accelerator which causes cursor motion to be 
scaled non-linearly against mouse motion. Acceleration only occurs if the mouse is moved at a 
speed greater than a threshold value. This accelerator is equivalent to the speed-doubling which 
some other mouse drivers provide. Without acceleration, the mouse resolution is 200 Steps per 
Inch (SPI). With fast mouse movement it may rise to 400 SPI. Acceleration is enabled by default. 
To disable acceleration, call function 19 with a very large speed threshold, say 7FFF Hex. 



1.2.11.1 Calling Function 11 from Assembler 

READ_MOT ION_COUNTERS : 
MOV AX. 11 
INT 33H 
MOV HORIZ, CX 
MOV VERT, DX 



1.2.11.2 Calling Function 11 from Modula-2 

MODULE test; 
IMPORT Mouse; 
VAR 

horizontal, vertical : INTEGER; 
BEGIN 

Mouse. ReadMoti encounters (horizontal, vertical); 
END test. 



1.2.113 Calling Function 11 from C 

testO 
i 

int horizontal, vertical; 
ReadMoti onCounters (&horizontal, &vertical); 
> 
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lJt.11.4 Calling Function 11 from Microsoft Pascal 

program test; 

procedure ReadMoti encounters (VARS horizontal, vertical : Integer);EXTERN; 

var 

horizontal, vertical : Integer; 
begin 

ReadMoti encounters (horizontal, vertical); 
end. 



1.2.11.5 Calling Function 11 from Turbo Pascal 

program test; 

<$i mouse. pas} (* LOGITECH HOUSE Turbo Pascal Interface *) 

var 

horizontal, vertical : Integer; 
begin 

ReadMoti encounters (horizontal, vertical); 
end. 



U.11.6 Calling Function 11 from Basic 

190 ■ assuming setup as in A. 2.1 

200 MIX » 11 

210 CALL H0USE(M1%, M2%, M3%, H4%) 



38 LOGITECH MOUSE Driver Functions 



1.2.12 FUNCTION 12 - DEFINE EVENT HANDLER 

This routine sets the address of a user subroutine to be called by the mouse driver on occurrence of 
a specified event. The driver temporarily stops execution of your main program and calls the 
specified subroutine whenever one or more of the conditions defined by the call mask occur. The 
call mask is a single integer value which defines the conditions which will cause an interrupt. Each 
bit in the call mask corresponds to a specific condition: 

Mask Bit Condition 

change cursor position 

1 press left button 

2 release left button 

3 press right button 

4 release right button 

5 press middle button 

6 release middle button 
7-15 not used 



Input 



AX=12 

CX = call mask 

ES:DX = address of event-handler routine 



Output 



none 



The event-handler itself must be a piece of code which starts at the address passed to Function 12. 
When the event handler is called, the following information is available in the registers: 

Register Information 

AX Event which occurred (1 bit set in format of event mask) 

BX Button State 

CX Horizontal Cursor Position 

DX Vertical Cursor Position 



Note: That the event handler is called fi-om the mouse driver during an interrupt (typically a serial 
port interrupt), which means that the event handler must behave as such. For example, it is usually 
not possible to call DOS fi:om the event handler. It is also strongly recommended to spend as little 
time as possible in the event handler. 

The recommended procedure for an event handler is to record the event in some kind of queue 
that is read by the main program. The mouse events then can be treated at the same level as 
keyboard input. 
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1^.12.1 Calling Function 12 from Assembler 



COUNTER label 


WORD 


DU 





MY_EVENT_HANDLER: 


PUSH 


AX 


MOV 


AX, COUNTER 


ADD 


AX, 1 


MOV 


COUNTER, AX 


POP 


AX 


SET_EVENT_HANDLER: 


MOV 


AX, 12 


MOV 


CX, 1 


PUSH 


CS 


POP 


ES 


LEA 


DX, MY_EVENT_HANDLER 


INT 


33H 



1.2.12.2 Calling Function 12 from Modula-2 

MODULE test; 

IMPORT Mouse; 

PROCEDURE EventHandler (events : Mouse. EventSet; 

buttons : Mouse. ButtonSet; 
X, y : INTEGER); 
BEGIN 

(* code to process the events - if there were many different 
events to process, this procedure could call other procedures 
to handle the different events *) 
END EventHandler; 

VAR 

eventMask : EventSet; 

BEGIN (* module initialization *) 

eventMask := O; (* initialize event mask to no events *) 

INCL (eventMask, LeftButtonPress); 

(* set event mask so that EventHandler is called only when the left button 

is pressed *) 

SetEvent Handler (eventMask, EventHandler); 

(* main body of program *) 
END test. 
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1.2.123 Calling Function 12 from C 

#define FALSE 
#define TRUE 1 

Int finished « FALSE; 
int quit = 0; 

/• the procedure EventHandler is called by the driver asynchronously whenever movement of the 
mouse occurs - the button status is then checked. If the right button is pressed, the global 
variable 'finished' is set to TRUE, the eventhandler returns and the program terminates. 
*/ 

EventHandler (eventSet, buttonSet, horiz, vert) 

int eventSet, buttonSet, horiz, vert; 

< 

if (buttonSet « 2) ^finished = TRUE; return;> 

/* if right button pressed then quit */ 
> 

testO 

SetEventHandler <9, EventHandler); /* event is called when mouse moves */ 

finished - FALSE; 

while (finished «« FALSE) 

/* loop */ 

> 



Function 12 - Define Event Handler 41 



12.12A Calling Function 12 from Microsoft Pascal 

program test; 

procedure SetEventHandler (mask : Integer; VARS handler : Integer); EXTERN; 

(* NB: declaration of the event handler must be as follows - it must be made PUBLIC so that it is 
identified by a long (doubleword) address to be called from the mouse driver. Note also that DOS 
function calls should not be made from within the event handler • this is because DOS is not re- 
entrant. Basically, this means be careful of calls such as Write, WriteLn etc which are usually 
translated into DOS calls. *) 

procedure MyEvent Handler (eventSet, ButtonSet, horiz, vert : Integer) 

[PUBLIC]; 
begin 

(* do something *) 
end; 

var 

eventMask : Integer; 
begin 

eventHask := 2; (* left button presses only *) 

SetEventHandler (eventHask, HyEventHandler); 
end. 



1.2.12.5 Calling Function 12 from Turbo Pascal 

program test; 

CSi mouse. pas> (* LOGITECH MOUSE Turbo Pascal Interface *) 

procedure HyEventHandler (eventSet,buttonSet, horiz, vert : Integer); 
begin 

(* do something *) 
end HyEventHandler; 

begin 

SetEventHandler (2 (*left button*), 0f8(MyEventHandler)); 
end. 



1.2.12.6 Calling Function 12 from Basic 

This function will require different treatment for different implementations of BASIC. 
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1.2.13 FUNCTION 13 - UGHT PEN EMULATION MODE ON 

This function enables light pen emulation by the mouse. When light pen emulation is enabled, a 
simultaneous press of the left and right mouse buttons will emulate the pen-down state of the light 
pen. Both mouse buttons released emulates the pen-up state of the light pen. 

Thus, programs which expect a light pen can be run with a mouse instead by &st calling function 
13. If a light pen is to be used along with a mouse, function 14 will switch off the light pen 
emulation. 

Light pen emulation is OFF by default. 

Input 

AX=13 

Output 

none 



1.2.13.1 Calling Function 13 from Assembler 

LIGHT_PEN_ON: 

MOV AX, 13 

INT 33H 



1.2.13.2 Calling Function 13 from Modula-2 

MODULE test; 
IMPORT Mouse; 
BEGIN 

Mouse . L 1 gh tPenOn; 
END test. 



1.2.13 J Calling Function 13 from C 
testo 

LightPenOnO; 
> 



1.2.13.4 Calling Function 13 from Microsoft Pascal 

program test; 

procedure LightPenOn; EXTERN; 

begin 

LightPenOn; 
end. 
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1.2.13.5 Calling Function 13 from Turbo Pascal 

program test; 

{$i mouse. pas> <* LOGITECH MOUSE Turbo Pascal Interface *) 

begin 

LightPenOn; 
end. 



1.2.13.6 Calling Function 13 from Basic 

190 ' assuming setup as in A. 2.1 

200 M1% « 13 

210 CALL M0USE(H1X, M2%, M3%, MA) 
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Here is a small test program to illustrate the use of a mouse in place of a light pen. It is written in 
IBM BASICA. The reference for the light pen functions is the IBM BASIC Reference 3.0. 

2 REH THIS PROGRAM TESTS THE LIGHT PEN EMULATION OF THE MOUSE DRIVER 

3 REM 

5 SCREEN : SCREEN 2 • graphics mode 640x200 

10 DEF SEG^O 

20 MSEG=256*PEEK<51*4+3)+PEEK<51*4+2> 

30 IF MSE6>0 THEN 90 

40 ENTRY«256*PEEIC(51*4+1 >+PEEK<51*4) 

50 DEF SEG^SEG 

60 IF PEEK(ENTRY)=207 THEN 90 

65 M0USE=ENTRY-«-2 

70 PRINT "MOUSE DRIVER PRESENT" 

80 GOTO 150 

90 PRINT "MOUSE DRIVER NOT LOADED" 

100 END 

150 GOSUB 800 ■ mouse driver function 0, Flag Reset 

170 IF M1X=-1 THEN 200 

180 PRINT "MOUSE NOT RESPONDING" : END 

200 PRINT "SETTING LIGHT PEN EMULATION ON" 

220 GOSUB 900 ' mouse driver function 13, Light Pen Emulation On 

224 GOSUB 600 ' mouse driver function 1, Show Cursor 

230 PRINT "TESTING LIGHT PEN EMULATION" 

232 PRINT 

235 PRINT "RIGHT BUTTON TO EXIT" 

236 PRINT "LEFT BUTTON STEPS THROUGH THE PEN FUNCTIONS 0-9" 

237 PRINT 
240 PEN ON 

242 PENFUNCTION=0 

245 GOSUB 700 ' mouse driver function 3, Get Position and Buttons 

246 IF M2%=0 THEN 245 

249 IF M2% AND 2 THEN SCREEN : END 'right button pressed 

255 GOSUB 700 • Get Position and Buttons 

260 IF M2X AND 1 THEN 255 

270 IF PENFUNCTION < 9 THEN PENFUNCTION = PENFUNCTION+I : GOTO 245 

280 PENFUNCTION x : GOTO 245 

490 REM 

500 • SUBROUTINE HIDECURSOR 

510 M1%=2 

520 CALL MOUSE (M1X, M2X, M3%, M4%) 

530 RETURN 

540 REM 

600 • SUBROUTINE SHOWCURSOR 

610 M1X=1 

620 CALL M0USE(M1X, M2X, M3%, M4%) 

630 RETURN 

640 REM 
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700 • SUBROUTINE GET POSITION AND BUTTONS 

710 M1%=3 

720 CALL M0USE(M1%, M2%, M3X, M4X) 

730 RETURN 

740 REH 

800 • SUBROUTINE FLAG RESET 

810 M1%=0 

820 CALL M0USE(H1X, M2X, M3X, MAX) 

830 RETURN 

840 REM 

900 • SUBROUTINE LIGHT PEN EMULATION ON 

910 MlX:s13 

920 CALL MOUSE (MIX, M2X, M3X, M4X) 

930 RETURN 
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1.2.14 FUNCTION 14 - UGHT PEN EMUIATION MODE OFF 

This function disables the light pen emulation mode. 

Input 

AX = 14 

Output 

none 



1.2.14.1 Calling Function 14 from Assembler 

LIGHT_PEN_OFF: 

MOV AX, 14 

INT 33H 



1.2.14.2 Calling Function 14 from Modula-2 

MODULE test; 
IMPORT Mouse; 
BEGIN 

Mouse. LightPenOff; 
END test. 



1.2.14 J Calling Function 14 from C 

testO 
i 

LightPenOffO; 
> 



1.2.14.4 Calling Function 14 from Microsoft Pascal 

program test; 

procedure LightPenOff;EXTERN; 

begin 

LightPenOff; 
end. 

1.2.14.5 Calling Function 14 from Turbo Pascal 

program test; 

{$i mouse. pas> (* LOGITECH MOUSE Turix) Pascal Interface *) 

begin 

LightPenOff; 
end. 
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1.2.14.6 Calling Function 14 from Basic 

190 ' assuming setup as in A. 2.1 

200 M1% ' 14 

210 CALL HOUSE (HI X, H2%, H3%, H4) 
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1.2.15 FUNCTION 15 - SET MOUSE MOTION/PIXEL RATIO 

This function sets the mouse motion to screen pixel ratio. 

The horizontal and vertical ratios specify the amount of mouse motion which is required to move 
the cursor 8 pixels. The allowable range of values is 1 to 32767 mickeys where a mickey is defined 
to be the unit of physical mouse motion (or if you like, hand movement). The value which should 
be set is dependent on the number of mickeys the mouse records per inch - some mice are 100 
mickeys/inch, others 200 or even 320. 

The default values are 8 steps to 8 pixels horizontally and 16 steps to 8 pixels vertically. For the 
LOGITECH MOUSE 200 mickeys/inch, this is equivalent to 3.2 inches of horizontal mouse 
movement and 2.0 inches of vertical mouse movement to move the cursor over the extent of a 
640x200 pixel screen. 



Input 

AX=15 

CX = horizontal step to pixel ratio 

DX = vertical step to pixel ratio 



Output 

none 



1.2.15.1 Calling Function 15 from Assembler 

SET_MICKEYS_PER_PIXEL: 
MOV AX, 15 

MOV CX, 16 ; horizontal 
MOV DX, 16 ; vertical 
INT 33H 



1.2.15.2 Calling Function 15 from Modula-2 

MODULE test; 
IMPORT Mouse; 
VAR 

horPix, verPix : CARDINAL; 
BEGIN 

horPix := 16; 

verPix := 16; 

Mouse. SetMickeysPerPixel (horPix, verPix); 
END test. 



1.2.15J Calling Function 15 from C 

teste ) 
<: 

unsigned horPix, verPix; 
horPix =16; 
verPix = 16; 

SetMickeysPerPixel (horPix, verPix); 
> 
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1.2.15.4 Calling Function 15 from Microsoft Pascal 

program test; 

procedure SetMickeysPerPixel (horPix, verPix : Integer);EXTERN; 

var 

horPix, verPix : Integer; 
begin 

horPix := 16; 

verPix := 16; 

SetMickeysPerPixel (horPix, verPix); 
end. 



1.2.15.5 Calling Function 15 from Turbo Pascal 

program test; 

{$i mouse.pas> (* LOGITECH MOUSE Turbo Pascal Interface *) 

var 

horPix, verPix : Integer; 
begin 

horPix := 16; 

verPix := 16; 

SetMickeysPerPixel (horPix, verPix); 
end. 



1.2.15.6 Calling Function 15 from Basic 

190 ■ assuming setup as in A. 2.1 

200 M1% = 15 

210 M3% s 16 

220 MAX = 16 

230 CALL M0USE(M1%, M2%, M3%, M4%) 
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1.2.16 FUNCTION 16 -CONfOmONAL HIDE CURSOR 

This function allows the user to define an area on the screen within which the mouse cursor will 
automatically be turned off. This function is used to guard a portion of the screen which your 
program is about to update. 

Calling the Show Cursor Function (function 1) - resets the region (i.e. cursor enabled over the 
whole screen). 

Like HideCursor, this function decrements the cursor counter. See ShowCursor and HideCursor 
for details. 



Input 



AX=16 
CX = left margin 
DX = top margin 
SI = right margin 
DI = bottom margin 



Output 

none 



1.2.16.1 Calling Function 16 from Assembler 

C0NDITI0NAL_0FF: 

MOV AX, 16 

MOV CX, 50 ; left margin 

MOV DX, 60 ; top margin 

MOV SI, 60 ; right margin 

MOV DI, 70 ; bottom margin 

INT 33H 



1.2.16.2 Calling Function 16 from Modula-2 

MODULE test; 
IMPORT Mouse; 
BEGIN 

Mouse. ConditionalOff (50, 60, 60, 70); 
END test. 



1.2.163 Calling Function 16 from C 

teste ) 

ConditionalOff (50, 60, 60, 70); 
> 
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1.2.16.4 Calling Function 16 from Microsoft Pascal 

program test; 

procedure ConditionalOff (left, top, right, bottom : Integer);EXTERN; 

begin 

ConditionalOff (50, 60, 60, 70); 
end. 



1.2.16.5 Calling Function 16 from Turbo Pascal 

program test; 

<$i mouse. pas> (* LOGITECH MOUSE Turbo Pascal Interface *) 

begin 

ConditionalOff (50, 60, 60, 70); 
end. 



1.2.16.6 Calling Function 16 from Basic 

nils function may not generally be used from BASIC due to the number of parameters to be 
passed. 
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1^.19 FUNCTION 19 - SET SPEED THRESHOLD 

This function allows the user to define a threshold speed (in units of mouse velocity, mickeys per 
second) of the mouse above which the driver will add in an acceleration component. This has the 
effect of allowing a fast movement of the mouse to move the cursor further than a slow movement. 
The acceleration component varies according to the implementation of the driver. On some drivers 
it is a constant multiplier, generally with a value of 2, on others it changes according to the 
increasing speed of the mouse, with multiplier values increasing over an acceleration curve. The 
Logimouse driver has the latter type of accelerator. 

To cancel the acceleration effect, SetSpeedThreshold may be called with a large value for the speed 
threshold - 07FFFH or some equivalently large number will certainly remove all acceleration. To 
restore acceleration again, SetSpeedThreshold should be called with a speed threshold value of 0. 



Input 



AX=19 

DX = threshold speed in mickeys/second 



Output 



none 



1.2.19.1 Calling Function 19 from Assembler 

SET_SPEED_THRESHOLD : 

MOV AX, 19 

MOV DX, 300 ; speed threshold 

INT 33H 



1.2.19.2 Calling Function 19 from Modula-2 

MODULE test; 
IMPORT Mouse; 
BEGIN 

Mouse. SetSpeedThreshold (300); 
END test. 



1.2.19 J Calling Function 19 from C 

testo 
i 

SetSpeedThreshold (300); 
> 



1 J.19.4 Calling Function 19 from Microsoft Pascal 

program test; 

procedure Setspeedthreshold (threshold : Integer);EXTERN; 

begin 

SetSpeedThreshold (300); 
end. 
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1.2.19.5 Calling Function 19 from Turbo Pascal 

program test; 

<$i mouse. pas> (* LOGITECH MOUSE Turbo Pascal Interface *) 

begin 

SetSpeedThreshold (300); 
end. 



1.2.19.6 Calling Function 19 from Basic 

190 ' assuming setup as in A. 2.1 

200 M1% « 19 

210 MA% » 300 

220 CALL MOUSE (Ml %, M2%, H3%, MA%) 
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13 EGA FUNCTIONS 

The EGA functions are installed as an extension of interrupt lOH. They are installed only if an 
Enhanced Graphics Adapter board is present on the system. Using these functions gives the 
application the capability to read back values in write-only EGA registers. In order to assure 
correct behavior, the application must use these functions exclusively instead of writing directly to 
the EGA. 

The registers are grouped as follow. A reference to an EGA register is made with a pair (group 
number, register number), or a whole group of registers may be referred to by a group number. 

Group Register 






0to24 


8 


Oto4 


16 


Oto8 


24 


0tol9 


32 





40 





48 





56 






Port 


Description 


3D4 


CRT Controller 


304 


Sequencer 


3CE 


Graphics Controller 


3C0 


Attribute Controller 


3C2 


Output Register 


3DA 


Feature Control Register 


3CC 


Graphics 1 Position 


3CA 


Graphics 2 Position 



Calling an EGA function consists of loading the input registers with the appropriate values as listed 
below and then initiating software interrupt 10 Hex. In 8086 assembly code, the sequence for 
function 250 is as follows: 

CALL_FN_250: 

MOV AX, 250 
MOV BX, 
INT 10H 



13.1 Read EGA Register - EGA Function 240 

Input 
AH = 240 

BX = Register number 
DX = Group number 

Output 
BL = Value of register 



The value of the register indicated by (DX,BX) is returned in BL. 
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13.2 Write EGA Register - EGA Function 241 

Input 

AH = 241 

DX = Group number 
Single Register: 

BL = Value to be written 

Register from a group: 
BL = Register number 
BH = Value to be written 

The register indicated by (DX, BL) is set to the value of BH. 



133 Read EGA Register Group - Function 242 

Input 
AH = 242 

ES:BX = Buffer address 
CH = Starting Register Number 
CL = Count 
DX = Group Number 

Output 
ES:BX to ES:BX+Count-l contains the values of the designated registers 



The values of the registers from group DX, numbered from CH to CH+CL-1 are copied to the 
buffer indicated by ES:BX. 



13.4 Write EGA Register Group - Function 243 

Input 

AH = 243 

ES:BX = Buffer address 

CH = Starting Register Number 

CL = Count 

DX = Group Number 

The registers from group DX, numbered from CH to CH+CL-1 are set to the values contained in 
the buffer indicated by ES:BX. 
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133 Read EGA Register list - Function 244 

Input 
AH = 244 

ES:BX = Address of Register List 
CX = Count 

Output 
ES:BX to ES:BX+Count*4 contains tlie values read 

TTie values of tlie registers described in the list indicated by ES:BX are transferred to the list. The 
list is a sequence of records in the form: 

WORD Group Number 
BYTE Register Number 
BYTE Value 



13.6 Write EGA Register list - Function 245 

Input 
AH = 245 

ES:BX = Address of Register List 
CX = Count 

The values contained in the list indicated by ES:BX are transferred to the indicated registers. The 
list has the same form as for function 244. 



13.7 Reset to Default Values - Function 246 

Input 
AH = 246 

This function resets the values of all the registers to the values defined using function 247. 



13.8 Set the Default Values - Function 247 

Input 
AH = 247 
ES:BX = Pointer to a table of one-byte register 

values, one for each register of the group 
DX = Group Number 

This function defines the table of default values used by function 246 for the given group. 
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13.9 EGA Functions Installed - Function 250 

Input 
AH = 250 
BX = 

Output 
BX = if not installed 

This function allows the application to detect if the EGA functions are installed. Register BX 
should be set to before calling the function. If it is still on return, the EGA functions are not 
installed. 
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NOTES: 
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CHAPTER 2 

THE LOGIMOUSE CURSOR DESIGNER 

FOR IBM PC & COMPATIBLES WITH CGA GRAPHICS. 



The Logimouse Cursor Designer (LCD) facilitates design of mouse cursors. It produces actual 
code to integrate in your application and is language independent. This is accomplished by means 
of loadable skeletons (templates) which define the structure of the output. Skeletons for several 
popular languages are provided. Customizing or creating your own skeleton files is simple. 



2.1 FILES 

The LCD program is the file LCD.EXE 

The skeleton files are called SKELJOOC v/heie XXX is a filename extension denoting the language. 
Thus SKEL.C is a skeleton for the C language. The output is simple enough that in most cases it is 
compatible with various implementations of a language. 



2.2 USING LCD 

Type LCD to run the program. 

LCD need the mouse driver to work and so this should be loaded first by typing MOUSE. If you 
try to run LCD without the mouse driver you will get the following error message: 

mouse driver not loaded 



23 THE MOUSE BUTTONS 

Left Button 
Right Button 
Middle Button 



paints a mask cell 

clears a mask cell 

sets the hot spot (the place on the cursor 
which dictates exactly where the cursor is 
actually pointing) 
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2.4 THE ICONS 

■ Load Skeleton 

Loads a skeleton file (SKEL.XXX). A directory of skeleton files available in the current 
directory is displayed. The default skeleton is SKEL.MOD (it is loaded automatically at 
the start). 

■ Save Cursor 

Saves cursor to a file in the format given by the current skeleton. Prompts for a name for 
the cursor. The file is created with the given name and an extension is added according to 
the current skeleton (eg if the cursor is given the name 'CROSS' and the current skeleton 
is 'SKELPAS', the output file will be called 'CROSSPAS'). 

■ Arrow 

Resets the cursor to an arrow. 

■ Install Cursor 

Installs the designed cursor as the current mouse cursor. 

■ Load Cursor 

Loads a cursor file for editing. Prompts for cursor name. Only the name of the cursor 
should be given and NOT the file extension (this is generated automatically from the 
current skeleton loaded). LCD uses the format of the loaded skeleton (default is Modula- 
2) to interpret the cursor file. The cursor file must have been created from the loaded 
skeleton file, otherwise LCD will not be able to interpret it and the message 

Cursor does not match skeleton 

will appear. 

When a cursor has been successfully loaded, a different skeleton may be loaded and the 
cursor saved in the new language format. Thus, if a cursor has been saved in C and it is 
required in Assembler, the C skeleton should be loaded, then the required cursor loaded 
followed by the Assembler skeleton and finally the cursor saved. 
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Make S From C 

Attempts to automatically generate a reasonable screen mask from the cursor mask. It 
does this by copying the cursor mask to the screen mask, inverting the screen mask and 
then 'padding-out' the outline. The screen mask may require some final editing to achieve 
the desired effect. 

Invert C 

Inverts the cursor mask 

Invert S 

Inverts the screen mask 

Clear C 

Qears the cursor mask 

Clear S 

Clears the screen mask 
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2.5 MAKING SKELETONS FOR OTHER LANGUAGES 

Skeleton files can be defined for other languages and you may wish to modify the existing ones. 
The structure of the skeleton file is very informal. The skeleton represents the code of the 
particular language being used. In a skeleton, the actual values of the cursor fields are replaced by 
variables, denoted by surrounding percentage signs, for example %?% denotes the cursor name, 
%HX% denotes the x coordinate of the hot spot. The LCD program reads the skeleton file and 
when it writes a cursor file, it copies the skeleton back out to the output file but substitutes the 
values of the designed cursor for the variables, for example, %P% might become MY_CURSOR, 
%HX% might become 7. 

Note: Be careful when using the name variable %P%. It must be followed by a non-alphabetic 
character such as yy_yy* or *yy;yy* etc. Names like %P%_Cursor or SetCursorTo%P% are legal but 
not %P%Cursor or Set%P%Cursor. 



2.5.1 LCD Skeleton Variables 

%P% The name of the cursor. 

%S0% The fields ofthe screen mask. 



%S15% 

%CQ% The fields of the cursor mask. 



%C15% 

%HX%The X coordinate of the cursor hot spot. 

%HY%The y coordinate of the cursor hot spot. 
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2.5.2 Example 1 : The Skeleton for LOGITECH MODUIA-2 

PROCEDURE SetCursorTo%P%; 

(* the use of the LOGITECH MODULA-2 interface to the mouse driver is assumed *) 



VAR 



cursor : Mouse. Graph icCursor; 



BEGIN 

WITH cursor DO 

screerMaskCD] := BITSET(XSOX); screenMask[1] 
screer^ask[2] := BITSET(XS2%); screenMask[3] 
8creenMask[4] := BITSET(%S4%); screenMask[5] 
screenMask [6] := BITSET(XS6%); screenMask[7] 
screenMask [8] :» BITSET(XS8%); screenMask [9] 
screenMask [10] z^ BITSET(%S10%);screenMask[11] 
screenMask [12] := BITSET(%Sl2X>;screenMask[13] 
screenMask [14] := BITSET(%Sl4%>;screenMask[15] 
cursorMask[0] :s BITSET(%COX}; cursorMask[1] 
cur8orMask[2] •.'^ BITSET(%C2%); cursorMask [3] 
cursorMask[4] :» bitseT(%C4%); cursorMask [5] 
cursorMask [6] z'^ BITSET(%C6%); cursorMask [7] 
cursorMask [8] := BITSET(%C8%); cursorMask [9] 
cursorMask [10] := BITSET(%C10%);cursorMask[11] 
cursorMask [12] ::= BITSET(%C12%>;cursorMask[13] 
cursorMask [14] :- BITSET(%Cl4%>;cursorMask[15] 
hotX := %HX%; hotY := %HY%; 

END; 

Mouse. SetGraph icCursor (cursor); 
END SetCursorTo%P%; 



« BITSET(%S1%); 
= BITSET(%S3%); 
= BITSET(%S5%); 
= BITSET(%S7%); 
= BITSET(%S9%); 
= BITSET(%S11X) 
e BITSET(%S13%) 
= BITSET<%S15%) 
= BITSET(%C1%); 
= BITSET(XC3%); 
= BITSET(%C5%); 
= BITSET(XC7%); 
= BITSET<%C9%); 
= BITSET(%C11%) 
s BITSET(%C13%) 
= BITSET<XC15%) 
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When this skeleton is loaded, a cursor designed and called "Cross", the resultant output file 
"CROSS.MOD" contains the following: 

PROCEDURE SetCursorToCross; 

(* the use of the LOGITECH MODULA-2 interface to the mouse driver is assumed *) 

VAR 

cursor : Mouse. Graph icCursor; 
BEGIN 
WITH cursor DO 

screenMask[0] := BITSET(-I); screenMask[1] := BITSET(-I); 

screenMask[2] :> BITSET(-I); screenMask[3] :- BITSET(-2017); 

screenMask[4] :- BITSET(-2017};screenMask[5] :=BITSET(-2017); 

screenMask[6] :^ BITSET(O); screenMask [7] :=BITSET(0}; 

screerMask[8] := BITSET(O); screerMask [9] :=BITSET(0); 

screertlaskCiO] := BITSET(-2017);screer«ask[11] :=BITSET(-2017); 

screenMask [12] := BITSET(-2017);screenMaskC13] :sBITSET(-1); 

screenMask [14] :« BITSET(-1); screerMask[15] :=BITSET(-1); 

cursorMask[0] :» BITSET(O); cursorMask[1] :=BITSET(0); 

cursorMask[2] := BITSEKO); cursorMask [3] :=BITSET(0); 

cursorMask[4] := B I TSET (960); cursorMask [5] :=BITSET(960); 

cursorMask[6] :» BITSET( 960); cursorMask [7] :::BITSET(32766); 

cursorMask[8] := BITSET<32766);cursorMaskt9] :=BITSET(960); 

cursorMask [10] :» BITSET(960>; cursorMask [11] :=BITSET(960}; 

cursorMask [12]:= BITSET(O); cursorMask [13] :=BITSET(0); 

cursorMask[14]:s BITSET(O); cursorMask [15] :=BI TSET (0); 

hotX := 7; hotY := 8; 
END; 

Mouse. SetGraph icCursor (cursor); 
END SetCursorToCross; 



2.53 Example 2 : The Skeleton for Microsoft C 

graph! cCursor_type XP%Cursor * 

C%SO%, %S1X, XS2X, XS3%, XS4%, XS5%, XS6%, XS7X, 
XS8%, XS9X, XS10%, XS11X, XS12X, XS13X, XS14X, XS15X, 
XCOX, XC1X, XC2X, XC3X, XC4X, XC5X, XC6X, XC7X, 
XC8X, XC9X, XC10X, XC11X, XC12X, XC13X, XC14X, XC15X, 
XHXX, XHYX >; 

When this skeleton is loaded, a cursor designed and called "Cross", the resultant output file 
"CROSS.C' contains the following: 

graph icCursor_type CrossCursor = 

€-1. -1, -1, -2017, -2017, -2017, 0, 0, 
0, 0, -2017, -2017, -2017, -1, -1, -1, 
0, 0, 0, 0, 960, 960, 960, 32766, 
32766, 960, 960, 960, 0, 0, 0, 0, 
7, 8 >; 



